5.1.1 建立提款數位幣至任意錢包
#簡要描述： 將數位幣提現到錢包的提現業務接口，讓用戶能夠將 usdt 轉移到指定的錢包地址 （市場匯率）
- 要求方式: POST
- 請求介面: https://网关域名/wallet-trade-merchant/v1/pay/blockchain/create
- 請求媒體類型( JSON 資料格式 )Content-Type: application/json
請求參數
| 參數名稱 | 類型 | 必填 | 參數意義 | 參數說明 |
|---|---|---|---|---|
key | string | 是 | 商家 key | apiKey |
localOrderId | string | 是 | 商家平臺本地訂單號碼 | 商家平臺本地產生唯一訂單號碼 |
localUserId | string | 否 | 商家平臺本機使用者ID | 商家平臺本機使用者ID |
amount | number | 是 | 金額 | 訂單金額 |
network | string | 是 | 主網 | 主網(目前僅支援 TRON、BSC、POLYGON、ETHEREUM) |
address | string | 是 | 提款位址 | 提款位址 |
notifyUrl | string | 否 | 回呼位址 | 下單成功後，由 API 回呼請求通知商家的位址 (回調詳情參照文件3) |
currency | string | 是 | 幣種 | 訂單幣種 |
userCurrency | string | 是 | 用戶實收幣種 | 用戶實收幣種 |
successRedirectUrl | string | 否 | 位址 | 成功後自動跳轉位址 |
isBlockchain | boolean | 否 | 是否回傳區塊鏈資訊（預設false） | 當為true時，回呼請求會攜帶訂單鏈上交易資訊 |
expireSecond | Long | 否 | 過期時間戳記（秒） | |
sign | string | 是 | 簽章 | 詳情請見簽章演算法 |
請求 json 範例
{
"key": "weOfDMRpUAvAeOs5",
"localOrderId": "TestOTM0625ROB017",
"notifyUrl": "http://www.baidu.com/728-TestOTM0625ROB01",
"amount": 20,
"network": "TRON",
"currency": "CNY",
"userCurrency": "USDT",
"successRedirectUrl": "http://www.baidu.com",
"address": "TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
"isBlockchain": true,
"sign": "834e924f7846fe3a65b53e6680c8e53a"
}
回應 json 範例
{
"code": 0,
"success": true,
"message": null,
"data": {
"orderId": 473220978729221,
"localUserId": null,
"localOrderId": "TestOTM0625ROB017",
"orderType": "WITHDRAW",
"orderBizType": "WITHDRAW_ANY_DIGITAL_WALLET",
"targetType": "EXTERNAL",
"network": "TRON",
"address": "TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
"currency": "CNY",
"userCurrency": "USDT",
"amount": "20",
"userAmount": "2.994723",
"userReceivableAmount": "2.994723",
"rate": "6.67841204",
"rateExpression": "1USDT≈6.6784CNY"
}
}
回應data 參數說明
| 參數名稱 | 類型 | 參數意義 | 備註 |
|---|---|---|---|
orderId | string | 訂單 ID | |
localUserId | string | 商家本地用戶 ID | |
localOrderId | string | 商家本地訂單號碼 | |
orderType | enum | 訂單類型 | PAYMENT：支付订单 | WITHDRAW：提款订单 |
orderBizType | enum | 訂單業務類型 | orderBizType 類型說明如下 |
targetType | enum | 目標類型 | targetType 類型說明如下 |
network | string | 主網類型 | |
address | string | 位址 | 鏈上收款位址 |
currency | string | 訂單幣種 | |
userCurrency | string | 到帳幣種 | |
amount | string | 訂單金額 | |
userAmount | string | 用戶實收金額 | |
userReceivableAmount | string | 用戶應收金額 | |
rate | string | 匯率 | |
rateExpression | string | 匯率表達式 |
orderBizType 類型說明：
1、PAYMENT_WALLET_SCAN MINPAY錢包掃碼支付 2、PAYMENT_TRANSFER 數位幣綁定地址直充 3、PAYMENT_ANY_DIGITAL_SCAN 數位幣任意金額掃碼支付 4、WITHDRAW_WALLET 提款至MINPAY錢包 5.WITHDRAW_ANY_DIGITAL_WALLET 提款數位幣至任意錢包 6、PAYMENT_FIXED_DIGITAL_SCAN 數位幣限定金額掃碼支付 7、BATCH_PAY 大量代付
targetType 類型說明：
1、INTERNAL 內部位址 2、EXTERNAL 外部位址 3、USER 使用者抽象位址
回呼返回 json 資料
回呼 data
{
"amount":"20",
"bizType":"WITHDRAW_ANY_DIGITAL_WALLET",
"blockchain":{
"network":"TRON",
"receiverAddress":"TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
"senderAddress":"TE35TrUfHjbGEBsVS6zVXdHS8HxXCWwC2y",
"txId":"c5503ecf1f0979d5bc7a7e16c3cad20290449913ab47a7e18dfca6ba6f2725fa"
},
"currency":"CNY",
"localOrderId":"TestOTM0625ROB017",
"merchantActualAmount":"57.32",
"merchantCurrency":"CNY",
"merchantId":302992856974,
"merchantPaidAmount":"20",
"notifyTime":1772259079786,
"orderCreateTime":1772259032870,
"orderId":"473220978729221",
"status":"SUCCESS",
"type":"WITHDRAW",
"userAmount":"2.994723",
"userCurrency":"USDT",
"userMinerFee":"0",
"userReceivableAmount":"2.994723",
"sign":"742e64d684648c32c7ad33cf8d5604e2",
"key":"9yUreYgTRtit39Dy"
}
當您收到回呼通知後，請在處理完成後直接返回字串 success，表示已成功接收並處理該訊息。 系統在收到 success 回應後，將不再對該筆回呼進行重複發送。 若未收到期 望回應（未回傳 success 或回傳異常），系統將依照階梯式重試機制重新傳送回呼通知，最多重試 14 次。 當前重試時間間隔依序為： 15s, 15s, 30s,180s, 600s, 1200s, 1800s, 1800s, 1800s,3600s,10800s,10800s,21600s, 21600s